\thispagestyle{empty}
\begin{center}
    \section*{前言}
\end{center}\par
    基于个人对\LaTeX{}的使用需求，这个\LaTeX{}模板Magicat（中译：魔法猫猫）诞生了，这是一个基于Xe\TeX{}与 \lstinline{article} 文档类的用于排版笔记，书籍与论文的类。本文的主要目的是Magicat的一些设置内容与使用方法，亦会列举相关示例。如果您在查阅本文后仍旧没有解决问题，欢迎通过以下方式联系我（为避免误会，请备注\LaTeX{}或Magicat等相关信息，感谢配合）：\par
    \begin{tcolorbox}[
        freelance,
        breakable,
        frame code={
            \draw[line width = 2pt]
                ([xshift=0.5cm]frame.north west) --
                (frame.north west) --
                (frame.south west) --
                ([xshift=0.5cm]frame.south west);
            \draw[line width = 2pt]
                ([xshift=-0.5cm]frame.north east) --
                (frame.north east) --
                (frame.south east) --
                ([xshift=-0.5cm]frame.south east);
        },
        colback=white
    ]
        \begin{description}
            \item[知乎]：\href{https://www.zhihu.com/people/sirinqwq}{@Elaina}；
            \item[Gitee]：\href{https://gitee.com/liqing-elaina-shi/magicat}{石礼晴/Magicat - A LaTeX Template}
        \end{description}
    \end{tcolorbox}
    本模板除去其中引用部分（如 \href{https://www.pixiv.net/member_illust.php?illust_id=99231226&mode=medium}{封面图} 等，我们不会提供相关源文件的下载，请自行查找）以外均遵循知识共享-署名4.0国际许可协议进行许可，访问 \href{http://creativecommons.org/licenses/by/4.0}{官方网址} 查看该协议的具体内容。\par
    本模板的测试环境为Overleaf（Xe\LaTeX{}编译+\TeX{} Live 2022），至于\TeX{} Live等环境，初步测试可以正常编译。关于\TeX{} Live的安装则可参考 \href{https://github.com/OsbertWang/install-latex-guide-zh-cn/releases}{这份文档}，在此不多赘述。需要注意的内容是，在安装\TeX{} Live可能会出现宏包缺失的情况，建议通过以下方法进行修改：使用cmd运行 \lstinline{tlmgr update --all} 或以下其一：
    \begin{lstlisting}[
        language={TeX},
        numbers=left,
        numbersep=2em,
        numberstyle=\footnotesize,
        frame=shadowbox,
        rulesepcolor=\color{red!20!green!20!blue!20}]
tlmgr update --self
tlmgr update --all
tlmgr update --self --all --reinstall-forcibly-removed
    \end{lstlisting}
    关于这部分请参考 \href{https://tex.stackexchange.com/questions/55437/how-do-i-update-my-tex-distribution}{How do I update my \TeX{} distribution?} 中的内容。另外，本模板调用的字体设置是 \lstinline{xeCJK} 的默认字体，所以请确保Fandol字体已经被安装。当您在使用本模板时，请确保没有使用C\TeX{}相关的内容（例如宏包 \lstinline{ctex} 与文档类 \lstinline{ctexbook} 等），这会使得 \lstinline{key-val} 选项失效，造成一定的问题。
    \par
    本模板基于 \lstinline{article} 文档类，所以 \lstinline{article} 的基本指令对本模板也都生效。我们并没有搭载\lstinline{\chapter}一类的用法，仅使用\lstinline{\section}代替章节，这是基于个人审美的选择。因此，本模板可以作为笔记、书籍与论文的排版，但具体的命令与使用方式与一般的基于 \lstinline{book} 的模板略有不同。我们提供了基于 \lstinline{key-val} 选项功能的诸多设定以供切换，这些内容将在正文中被提及。诸多具体设置等相关内容敬请参考正文中内容，我们在此只是基于本模板的特点进行一些说明。
    \par
    本模板自开发阶段至今经若干次修改，在此感谢我的朋友们对此的帮助，并感谢帮我进行测试的朋友们。